home *** CD-ROM | disk | FTP | other *** search
/ ClipArt Heaven 2 / ClipArt Heaven 2.iso / utility / pcxdmp80 / pcxlab.doc < prev    next >
Text File  |  1993-04-12  |  15KB  |  295 lines

  1.  
  2.                         PCXLAB 1.00
  3.  
  4.                 Copyright (c) Jesper Frandsen
  5.  
  6.                       April 13., 1993
  7.  
  8.               =================================
  9.  
  10.  
  11.  
  12.   DISCLAIMER
  13.   ----------
  14.   This product is distributed AS IS. The author specifically disclaims all
  15.   warranties, expressed or implied, including, but not limited to, implied
  16.   warranties of merchantability and fitness for a particular purpose with
  17.   respect to defects in the diskette and documentation, and program license
  18.   granted herein, in particular, and without limiting operation of the
  19.   program license with respect to any particular application use or purpose.
  20.   In no event shall the author be liable for any loss of profit or any other
  21.   commercial damage including but not limited to special, incidental,
  22.   consequential or other damages.
  23.  
  24.  
  25.   LICENSING AGREEMENT
  26.   -------------------
  27.   PCXLAB is copyrighted software and all rights are reserved. PCXLAB may
  28.   not be changed or modified in any way except by the author. PCXLAB is
  29.   part of the PCXDUMP system. The PCXDUMP system is SHAREWARE and may be
  30.   freely distributed as long as it remains in its complete form with all
  31.   support and documentation files. It may be used for a 10 day free trial
  32.   period. Regardless of how the copy is obtained, it is requested that all
  33.   users comply with the following licensing and registration provisions if
  34.   they continue to use it after the 10 day trial period. Should you find
  35.   this program useful, you must register it; you will then be provided with
  36.   the latest releases of the PCXDUMP system.
  37.  
  38.  
  39.   OVERVIEW OF PCXLAB
  40.   -------------------
  41.   * It can be used on any color EGA, VGA or SVGA display card (except
  42.     EGA mono).
  43.  
  44.   * It can show any 2, 16, 256 and 16.7 million (24 bit) color PCX file
  45.     in both 16 and 256 color modes. However viewing real 256-color and
  46.     24 bit pictures in 16 color will only give you a hint of the picture.
  47.     Viewing 24 bit pictures in 256 color is acceptable.
  48.     If the images displayed is bigger than the current resolution you can
  49.     scroll the images around FAST with the arrowkeys and PgDn & PgUp. You
  50.     can also change resolution with '+' or '-'.
  51.  
  52.   * It detects these SuperVGA card and uses their HiRes modes in 16 or
  53.     256 colors:
  54.     ATI-VGA, Trident, Genoa, Paradise, Tseng 3000, Tseng 4000, MXIC, Realtek
  55.     OAK-37, OAK-67, OAK-77, Video7, Ahead A/B, Chips & Tech 451/452/453 and
  56.     VESA compatible cards.
  57.  
  58.   * On HiColor or TrueColor cards, you can view 24 bit colors PCX files in
  59.     32768 colors or 16.7 million colors (TrueColor card needed for this).
  60.     PCXLAB will use the HiColor extensions on these cards:
  61.     Tseng ET 4000, Paradise, Realtek, OAK-77, Trident, ATI, VESA.
  62.     With the proper VESA-driver, you will be able to show images in
  63.     16.7 million colors (if supported by videoadapter).
  64.  
  65.   * It has a neat file browser, so you can walk through your whole harddisk
  66.     without leaving PCXLAB. There is a limit of 2000 PCX-files per
  67.     directory (you are not likely to hit this limit!). You simply use the
  68.     cursor arrows or PgUp or PgDn to select the file you want to see. Press
  69.     Enter to view file.
  70.  
  71.   * The PCX-files must be no larger that 3800 pixels wide, which should be
  72.     more than enough.
  73.  
  74.   * You can easily set up a slideshow by tagging a number of files and then
  75.     hitting F8 (to start the slideshow). You must tag at least 2 files to
  76.     have a slideshow.
  77.  
  78.   * PCXLAB will detect which videomodes your videocard can use, and you
  79.     can easily switch between these modes by pressing F2 (or + & -).
  80.  
  81.   * It is FAST! PCXLAB is written in a high level language and assembler
  82.     for all the screen and unpacking operations.
  83.     Compared with the great shareware fileviewer VPIC (which can show a large
  84.     number of formats, not only PCX), PCXLAB is 30%-700% faster with an
  85.     average about 2 times faster as VPIC!
  86.  
  87.   * Converts PCX-files to other fileformats: Postscript, Windows BMP, Amiga LBM
  88.     TIFF, Targa TGA, Wordperfect WPG.
  89.  
  90.   * Manipulate PCX-files:
  91.     1) Convert color files to monochrome with Floyd/Steinberg or Burkes
  92.        dithering.
  93.     2) Reduces 256 or 16.7 million color PCX-files to 16 or 256 colors.
  94.     3) Converts color PCX-files to gray scaled PCX-files.
  95.  
  96.   * Shows both PCX-files and ANS-files (ANSI text files)
  97.  
  98.   * Shows images from commandline.
  99.  
  100.  
  101.   USAGE
  102.   -----
  103.   USAGE: PCXLAB [/CHIPSET=number] [File1 [File2] ...]
  104.  
  105.        If one or more arguments are valid filenames on PCX- or ANS-files,
  106.        these will be showed. Otherwise the PCXLAB will start as usually.
  107.        If PCXLAB somehow fails to recognize your video adapter that you
  108.        know is on the list below, you can force PCXLAB to use it with the
  109.        /CHIPSET switch.
  110.        The number must be in the range 2-23:
  111.  
  112.             Number  Chipset              Number    Chipset
  113.             ----------------------       -------------------
  114.                 0   UNSUPPORTED              12    OAK-67
  115.                 1   RESERVED                 13    Video 7
  116.                 2   EGA-card                 14    Ahead A
  117.                 3   VGA-card                 15    Ahead B
  118.                 4   ATI-vga                  16    Chips & Technology 451
  119.                 5   Trident                  17    Chips & Technology 452
  120.                 6   Genoa                    18    Chips & Technology 453
  121.                 7   Paradise                 19    VESA
  122.                 8   Tseng 3000               20    Tseng 4000 TrueColor
  123.                 9   Tseng 4000               21    OAK-77
  124.                10   Tseng 4000 HiColor       22    MXIC
  125.                11   OAK-37                   23    Realtek
  126.            
  127.        By forcing PCXLAB to use your adapter you will not be able to use
  128.        your videocards HiColor extension (if it has any)!
  129.  
  130.  
  131.   FILE CONVERSION - F3
  132.   --------------------
  133.        WPG FILES - MAXIMUM BITS: 8 (OR MAYBE 4)
  134.        ----------------------------------------
  135.        These are the native import graphic files for WordPerfect. These
  136.        files can contain both bitmaps and line art, or vector graphics.
  137.        PCXLAB will only generate the bitmapped part of them.
  138.        PCXLAB will deal with WPG files having one, four or eight bits of
  139.        color information, that is, monochrome files, sixteen-color files
  140.        and 256-color files.
  141.        The WPG specification allows for 256-color files. As of this writing,
  142.        WordPerfect itself would not read them. If you wish to use 256-color
  143.        images in a WordPerfect document, you might want to either reduce
  144.        them to sixteen colors or dither them to monochrome, depending upon
  145.        what you'll be outputting them to.
  146.  
  147.        BMP FILES - MAXIMUM BITS: 24
  148.        ----------------------------
  149.        These are the files which are used as "wallpaper" under Windows
  150.        3. They can be created using the version of PC Paintbrush
  151.        supplied with Windows.
  152.        BMP files use no image compression, as the intention appears to
  153.        be to make them fast to load. Plan on your BMP files being very
  154.        large.
  155.        There is a very important aspect of color BMP files which you
  156.        should bear in mind when you use this format. Windows uses a
  157.        fixed palette which Windows Paint cannot go about changing, as
  158.        doing so would make the screen and border colors change too.
  159.        This means that transferring an image to the BMP format will
  160.        generally result in some color shifts when BMP files are
  161.        imported into Windows applications.
  162.        The BMP format can support 24-bit files, which PCXLAB does
  163.        generate. However, as of this writing importing a 24-bit BMP image
  164.        into Windows Paint results in a noticeable color shift.
  165.        This appears to be a peculiarity of Windows Paint.
  166.  
  167.        EPS FILES - MAXIMUM BITS: 8
  168.        ---------------------------
  169.        The EPS format... encapsulated PostScript... isn't really a
  170.        bitmapped format at all. However, it may contain bitmapped data.
  171.        PostScript cannot be interpreted directly by most PC
  172.        applications. As such, an EPS file which is to be imported into
  173.        an application such as Ventura Publisher or PageMaker also
  174.        includes a "preview". A preview is a small black and white TIFF
  175.        image which will show you a rough idea of what the EPS file will
  176.        look like. PCXLAB will not generate a preview.
  177.        If you import an EPS file into Ventura, for example, the screen
  178.        image you see will be the preview but the data printed to your
  179.        printer will be the PostScript data itself.
  180.        PCXLAB can transform PCX-files with between 1 and 24 bits of
  181.        color information... between two and 16.7 million colors...
  182.        into EPS files. Images with more than two colors will be turned
  183.        into PostScript halftones.
  184.        Please note that the EPS files which PCXLAB creates are only
  185.        intended to be printed. You cannot read them into applications
  186.        such as Corel Draw or Adobe Illustrator. These applications
  187.        will not accept the large mounts of bitmapped data which a
  188.        PCXLAB EPS file contains.
  189.        For the most part, using EPS files in this way is no longer
  190.        necessary. Applications which import EPS files will usually allow
  191.        you to import TIFF files as well, which will provide you with
  192.        much better halftoning and screen control.
  193.  
  194.        TIFF FILES - MAXIMUM BITS: 24
  195.        -----------------------------
  196.        PCXLAB generates 1, 4, 8 or 24 bit TIFF files.
  197.        Color TIFF files are useful in Corel Draw, among other places.
  198.        Corel Draw 3.0 will import color TIFF files for inclusion in
  199.        CDR graphics.
  200.        Due to the complicated nature of TIFF-files PCXLAB will only
  201.        dump uncompressed TIFF. This will allow almost any TIFF-reader
  202.        to read the files generated by PCXLAB without choking.
  203.  
  204.        IFF/LBM FILES - MAXIMUM BITS: 24
  205.        --------------------------------
  206.        These started out on the Amiga. The IFF file standard is
  207.        extremely flexible, and allows all sorts of things besides
  208.        images to be stored in IFF files. IFF files are found on the PC
  209.        having been ported from Amiga systems. They are also created on
  210.        the PC by several applications such as Electronic Arts' Deluxe
  211.        Paint package and Digital Vision's Computer Eyes video scanner
  212.        board. In the first case they are given the extension LBM. In
  213.        the second they are given the extension CE. The basic file
  214.        structure is the same, however.
  215.        The standard form for IFF image files is called ILBM,
  216.        compressing all images as planes. This is much slower, but it
  217.        means that files thus compressed will be readable by pretty well
  218.        all IFF readers... even if you port 'em back to the Amiga. This
  219.        is how PCXLAB creates IFF files. Unfortunately, there's a problem
  220.        with old versions of Deluxe Paint which will occasionally cause
  221.        them to stop reading one of these files part way through the image.
  222.        This happens to IFF files from sources other than PCXLAB, so it's
  223.        probably a bug in these versions of Deluxe Paint.
  224.  
  225.        TGA FILES - MAXIMUM BITS: 24
  226.        ----------------------------
  227.        The Truevision Targa format is used by several high end paint
  228.        programs and things like ray tracing packages. It can handle
  229.        images with up to sixteen million unique colors.
  230.        PCXLAB will generate 1, 4, 8, or 24 bit TGA files. As with
  231.        TIFF files, PCXLAB will only generate uncompressed TGA files.
  232.  
  233.  
  234. DITHERING - F4
  235. --------------
  236.        Dithering is a sort of magical process by which color images can
  237.        be converted into pretty attractive black and white versions for
  238.        reproduction on a monochrome screen or a black and white laser
  239.        printer.
  240.        Note that source files for dithering must have more than one bit
  241.        of color information.
  242.        Dithering often works a lot better if you scale the original
  243.        image up. PCXLAB lets you dither with images from "size as" up to
  244.        300 percent expansion.
  245.        Note that the F4 function only dithers to monochrome. Color
  246.        dithering is handled by one of the functions of the F5 key.
  247.        Dithering is a fairly slow process, and the better the dithering
  248.        algorithm, the slower it gets.
  249.        If you have PCXLAB dither a file, it will create a new file for
  250.        you of the type selected and with "$" as the first char in the name.
  251.        Thus PICTURE.PCX could be dithered to $ICTURE.PCX, for example.
  252.        PICTURE.PCX would be left untouched.
  253.        The two dithering algorithms use what is called "error diffusion".
  254.        These produce really nice looking dithers, but they're quite slow.
  255.        The fastest... and least attractive... is Floyd-Steinberg. The
  256.        better... and slower... is Burkes (in my opinion).
  257.        It is possible to adjust the brightness and contrast of dithered
  258.        image with the GAMMA and CONTRAST values. Also it is possible to
  259.        invert the dithered image.
  260.  
  261.  
  262. COLOR REDUCTION - F5
  263. --------------------
  264.        This function allows you to create destination files with fewer
  265.        colors than the source files they're derived from. You can use
  266.        this function, for example, to reduce a 256-color file down to a
  267.        16-color one. It's particularly useful for reducing 24-bit files
  268.        down to 256-color files.
  269.        Whenever you reduce the number of colors in a file, some image
  270.        information will get lost. The simplest form of color reduction
  271.        is "remapping". This simply means that the destination image will
  272.        have the best color palette it can, and that all the pixels in
  273.        it will be replaced with colors from that palette. The results
  274.        aren't usually very attractive.
  275.  
  276.        Color dithering, also available in this function, can produce
  277.        decidedly better results. With color dithering, you can reduce
  278.        24-bit files down to eight bits with very little loss of detail
  279.        or color resolution.
  280.        If you have PCXLAB color dither a file, it will create a new file
  281.        for you of the type selected and with "!" as the first char in the
  282.        name. Thus PICTURE.PCX could be dithered to !ICTURE.PCX, for example.
  283.        PICTURE.PCX would be left untouched.
  284.  
  285.        Gray scale
  286.        ----------------
  287.        This function creates a gray scale destination image from a
  288.        color source image. The number of bits of color will remain the
  289.        same, although when grayscaling a 24-bit image, the destination
  290.        image will be a 8-bit image.
  291.        If you have PCXLAB dither a file, it will create a new file for
  292.        you of the type selected and with "#" as the first char in the name.
  293.        Thus PICTURE.PCX could be dithered to #ICTURE.PCX, for example.
  294.        PICTURE.PCX would be left untouched.
  295.